home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Development Platforms / Apple II / Essentials / APW.ORCA.Cmds / Gregs.APW.Utils / Documentation / ClrFF < prev    next >
Encoding:
Text File  |  1990-07-19  |  2.5 KB  |  49 lines  |  [TEXT/pdos]
  1. ClrFF -- Remove files from the FastFile file caching subsystem
  2.  
  3. Syntax      ClrFF
  4.  
  5. Description In version 1.1 of the ORCA shell, ByteWorks introduced the FastFile
  6.             high level file caching subsystem.  This system works by loading
  7.             and managing disk images of files in memory for quicker access by
  8.             compilers, linkers, and other tools that work with the FastFile
  9.             system.  (See the appropropriate Orca/M documentation for details.)
  10.  
  11.             One side effect of the FastFile system is that memory is used to
  12.             keep these file images in memory.  This means that less memory is
  13.             available for use by the rest of the system.  This utility is used
  14.             to remove these files from the FastFile system, and thence from
  15.             memory, to free up memory for use by the remainder of the system.
  16.             It does this by making FastFile calls to first determine which
  17.             files are being maintained by the system, and then deleting these
  18.             files from the system.  The disk copy of these files is NOT
  19.             modified in any way.  The utility then searches for any purgeable
  20.             memory blocks, and purges any that it finds.  Finally, it reports
  21.             on memory usage statistics, such as amount of memory in use, amount
  22.             of free memory, and total amount of memory installed.
  23.  
  24. Input       None.
  25.  
  26. Output      Standard output is used for all normal output.  This consists of
  27.             the filenames of files discovered in and deleted from the FastFile
  28.             system, purgeable memory blocks as they are discovered and purges,
  29.             and the memory usage statistics
  30.  
  31. Diagnostics Error messages are written to diagnostic output.
  32.  
  33. Status      The following status codes may be returned to the shell:
  34.  
  35.             0   No errors.
  36.             -1  An error occurred.
  37.  
  38. Options     None.
  39.  
  40. Known Problems.
  41.             Once in a while, the FastFile system will get stuck when the last
  42.             file in the system is deleted.  The file will not actually be
  43.             deleted from the system.  Since the utility loops through the files
  44.             in the cache until it receives a File-Not-Found error from the
  45.             FastFile call, this could cause a non-terminating loop condition to
  46.             occur.  If this happens, simply press the Command-. (period) key
  47.             sequence to tell the utility to terminate the clearing process and
  48.             continue on with the memory purge.
  49.